# Dungeon Crawler (working title)

Zyel Studios · Gaming · local third-person movement and shooting prototype.

## Launch on Ryzel

Open `build/DungeonCrawler-win64/Dungeon Crawler.exe`. Keep that whole folder
together. It runs outside Blender and needs no account or internet connection.
F11 toggles fullscreen; Escape pauses and releases the mouse. Close the window
to stop the game and its loopback-only server.

Source development: run `tools/electron/electron.exe .` from this folder, or
`node server.mjs` and open `http://127.0.0.1:43210/` in a desktop browser.
No editor is needed for gameplay. Browser edition and desktop edition share the
same Three.js/Cannon runtime. See `evidence/discovery.md` for earlier work.

## Controls

| Input | Action |
|---|---|
| WASD / mouse | Camera-relative movement / third-person look |
| Space, then Space in air | Jump plus one double jump |
| W, W | Forward roll; keep the second W held to sprint out of it |
| A, A / D, D | Roll left / right |
| S, S | Backward evasive backflip |
| Left mouse / right mouse | Fire / closer aim |
| 1 / 2 / 3 | Shotgun / machine gun / flamethrower |
| Escape | Pause and release mouse; click Return to resume |
| Backspace | Reset character, route and targets to start |
| F3 / F11 | Performance display / fullscreen |

Distinct presses are required for double taps; key repeat never triggers them.
The default window is 250 ms. Evades require ground contact and have a cooldown.
All three weapons have unlimited practice ammunition. Targets fall when depleted
and reset automatically after two seconds. Bullets and flame check cover.

## First route

Walk through the central arch. Turn left and climb the copper-edged ramp to the
gantry. Jump near the end of the first platform, then press Space again while
airborne to clear the four-meter gap. Reach the far ring, then head to the firing
range on the right. The central circle is clear space for four-direction evades.
Holding W after a forward roll enables sprint until W is released.

## Tuning and graphics

`public/config.json` groups speeds, acceleration, jump heights, capsule dimensions,
slopes, evade distance/duration/cooldown/timing, camera and weapon parameters.
Settings & sound also offers a 160–400 ms tap window, mouse sensitivity, three
graphics presets, independent player voice and effects volume, and reduced kick.
Preferences are saved locally. Balanced renders at native resolution; Low uses
80% resolution without shadows; High uses 150% resolution. Performance and tested
hardware/settings are recorded in `evidence/test-report.md`; laptop compatibility
is not claimed without a laptop test.

## Editable art and replacement

`art/blender/ranger-master-v01.blend`, `vault-kit-master-v01.blend` and
`weapons-master-v01.blend` retain editable source. The Ranger master packs its
original full-resolution textures and animation actions. Runtime textures are
downscaled to 1024 px. `scripts/prepare-art.py` rebuilds the runtime GLBs with
Blender 4.5 LTS. This work used the existing Blender 4.5.9 LTS on Ryzel.

Movement is independent from the model. Replace `public/assets/ranger.glb` and
the bone/hand mapping in `public/character.mjs`; keep meter scale, +Z character
forward and the named animation contract. The full turn/flip is a visual pivot;
collision uses an upright capsule, so an animation cannot rotate through a wall.
Two-hand IK targets shared grip sockets on the three weapons. Palettes are
Verdigris, Ember and Ivory on the same mesh and rig.

`scripts/prepare-audio.py` rebuilds the sound banks from retained selected sources
in `art/audio-source/` and the publisher archives in `downloads/`. Source URLs,
creators, exact CC0 editions, hashes, edits and optional credits are in `licenses/`.
The main banks are 30 action vocal takes, 30 separate jump/evade vocal takes and
30 designed cloth/impact foley variations. Foley layers are edits of real CC0
recordings; they are not described as 30 newly recorded roll performances.

For a fresh source-package checkout, install the audio preparation dependencies with
`python -m pip install -r requirements-art.txt --target tools/python`. The Blender
and audio scripts fall back to the retained selected source assets when the full
publisher archives are absent. `python scripts/bootstrap-desktop.py` downloads the
pinned official Electron build before repackaging. Downloaded archives and developer
tools are not required to play the provided Windows build.

## Build and verification

Use Node 24+ for the scripts: `node --test tests/*.test.mjs` checks controller,
collision, jump limits, tap detection, camera and audio shuffle behavior.
`node scripts/package.mjs` copies the verified Electron runtime and game into
the local Windows build. `scripts/bootstrap-desktop.py` obtains the official
Electron prebuilt archive and verifies the upstream SHA-256 before extraction.
`scripts/verify-packaged.cjs` runs the real packaged application and retains
functional results, screenshots and measured frame timing in `evidence/`.

## Licenses

Quaternius Standard character/outfit/animation assets and selected Kenney assets
are CC0-1.0. Voice, firearm and fire recordings have exact per-download CC0 receipts.
Three.js and Cannon-es use MIT licenses. Electron and Chromium notices are shipped
with the build. See `licenses/asset-manifest.json`, `audio-manifest.json`,
`download-receipts.json`, `upstream/`, and the in-game credits. Creator credit does
not imply endorsement. No premium assets, subscriptions or ripped game content.

This isolated prototype preserves the original Impact Lab and unrelated Studios,
Eveardel and Zyel projects. No OpenAI Sites tools or hosting are used.
